 Host Mode
 ---------

 The Softerm Host mode provides a general-purpose, unattended, remote
 access mode which can be used interactively by other terminals and
 systems.  This is similar to an electronic BBS.

 It can transfer files using the Character, Kermit, Sodtrans, Xmodem,
 Ymodem or Zmodem protocols.  Host mode functions as a server for the
 Kermit-Server, Softrans and Zmodem file transfer protocols by
 automatically detecting a protocol block while waiting for a command
 from the user.  This means that a command to initiate the file transfer
 is not required.


 Host Mode Interactive Commands
 ------------------------------

 Host mode responds to 28 interactive commands which you enter.  The Host
 system will transmit the following prompt when it is ready to receive a
 command:

                    Ready

 The following control characters may be used:

      Character      Action
      ---------      ------

      BS ($08)       Delete previous character
      DEL ($7F)      Delete previous character
      ESC ($1B)      Cancel command line
      CTRL C ($03)   Cancel output
      CTRL S ($13)   Stop Display
      CTRL Q ($11)   Resume Display

 To abort the display of a file typed or a directory list, press CTRL C.
 Output also is aborted if you press CTRL S to stop the display and it is
 not resumed within 30 seconds.  Host mode will timeout and display the
 Ready prompt.


 Important
 ---------
 All commands are issued by the caller and tell Host mode to do something.
 e.g.: If you want to send a file, you must instruct Host mode to prepare
 to receive a file.


 Exceptions to the Rule
 ----------------------
 Because Host mode acts as a server for the Softrans and Kermit-Server file
 transfer protocols, there are no commands to send and receive using those
 protocols.  You simply need to initiate the file transfer operation.

 Many of the Host commands require arguments.  The command and argument
 must be separated by at least one space.


 HELP
 ----
 Display this Help information.


 BYE
 ---
 Terminate the current Host mode session and disconnect.


 ACCEPT [-,&] d:\path\filename
 -----------------------------
 Used by the caller to send a file using character protocol.  The filename
 argument specifies the name of the file to receive the data.

 If the very first character of the path\filename is a hyphen (-), the file
 will replace a file of the same name on the Host system.

 Example:

      ACCEPT -C:\SOFTHOST\TEST.TXT

 If the very first character of the path/filename is an ampersand (&), the
 file will append to a file of the same name on the Host system.

 Example:

      ACCEPT &C:\SOFTHOST\TEST.TXT

 If a file of the same name exists and neither special character is used,
 the transfer will fail.

 The host will display a GO> prompt when the system is ready to accept
 data.  Characters can be typed by the caller or a file can be transferred
 using character protocol.

 The ACCEPT command is terminated by a Ctrl Z character or a 60-second
 timeout.


 CALL d:\path\filename 1='string1'...5='string5'
 -----------------------------------------------
 Run a script file and then return to the Host mode.  If logon processing
 is in effect, all subsequent commands will observe the access restrictions
 for the current user.

 Note:  We recommend that the CALLed script file does not end with the
 CONVERSE command.  This command places the Host Mode machine in Online
 terminal emulation mode with unpredictable results.

 The command line may include optional switches to specify the contents of
 the Script Variables SV1-SV5 used in the script file as follows:

    Switch         Function
    1='string'     Replaces SV1 in script file
    .    .    .    .    .    .
    5='string'     Replaces SV5 in script file

 Note:  The quote marks are optional and would be necessary only if the
 string contained embedded spaces.

 Up to 5 strings can be specified which are substituted for dummy arguments
 in the script file when the script file is run.  Each string may be up to
 64 characters in length.  A dummy argument is defined in the script file
 as SV followed by a number from 1 through 5.  Thus, wherever SV1 occurs in
 the script file, it will be replaced by the string defined for the SV1=
 switch in the CALL command line.  Note:  The maximum length of the command
 line is restricted to 128 characters.


 CD d:\path
 ----------
 Change the current default directory used for file names specified in file
 transfer operations used in the Host mode.  The new default directory,
 including a drive specifier and directory path, is entered as an argument
 on the command line.  If the optional Host mode logon processing is inhe
 current username.


 CURRENT
 -------
 Display the default directory for file transfer operations used in the
 Host mode.  It initially is set to the current default directory when the
 HOST() command is processed, or to the subdirectory in the password file
 for the current user.


 DELETE d:\path\filename
 -----------------------
 Remove an unwanted file from disk.  If no drive or directory path is
 entered, the file is deleted from the current directory.  You can use the
 wildcard characters ? and * in the filename and in the extension.

 This command can be abbreviated to DEL.


 DIR d:\path\filename
 --------------------
 The DIR command displays a list of the filenames in a specified directory.
 If no drive or directory path is specified, all files in the current
 default directory will be listed.  The wildcard characters * and ? may be
 used in the filename and extension parameters to list a subset of the
 files in the specified directory.


 ECHO <On or Off>
 ----------------
 This command turns echo mode for the ACCEPT command on or off.  If the
 argument is specified as ON, characters transmitted to the host using an
 ACCEPT command will be echoed back to the remote terminal or system for
 visual confirmation.  If the argument is specified as OFF, characters
 received are not echoed.  The echo mode defaults to ON.


 KSEND d:\path\filename
 ----------------------
 Prepare the Host system to send a file using the Kermit protocol.  This
 command can be used by remote Kermit programs unable to access a Kermit
 server.  The command is equivalent to a Kermit protocol SEND command.  The
 wildcard characters * and ? may be used in the filename or extension to
 allow multiple files to be sent using a single command.


 LF <On or Off>
 --------------
 This command turns the line feed mode for the TYPE and ACCEPT Host mode
 commands on or off.  If the argument is specified as ON, the host will add
 line feed characters after carriage returns in transmitted or echoed data.
 If the argument is specified as OFF, no line feed characters are added.
 The line feed mode initially is set to ON.


 LOGOUT
 ------
 Terminate the current Host mode session and restart with logon processing
 without a disconnect.


 RECEIVE <profile_name or protocol_name> filename
 ------------------------------------------------
 Prepare the Host system to receive the designated file using the 
 specified File Transfer profile or File Transfer Protocol.  If a profile 
 and a protocol share the same name, the command will use the profile.

 Note:  This method lets you use the Honeywell-Kermit protocol with the
 desired GCOS Mapping setting by using the appropriate profile.


 RENAME d:\path\filename1 d:\path\filename2
 ------------------------------------------
 Change the name of a file in the current or a specified directory.  The
 first file name entered with optional drive and path specification is the
 file to be renamed, and the second file name is the new name.  A drive or
 path specification is not allowed in the new filename.  The ? and *
 wildcard characters are allowed.

 This command can be abbreviated to REN.


 SEND <profile_name or protocol_name> filename
 ---------------------------------------------
 Prepare the Host system to send the designated file using the specified
 File Transfer profile or File Transfer Protocol.  If a profile and a
 protocol share the same name, the command will use the profile.

 Note:  This method lets you use the Honeywell-Kermit protocol with the
 desired GCOS Mapping setting by using the appropriate profile.


 TERMINATE
 ---------
 Terminate Host mode processing to interact directly with the script file
 from which the HOST() command was started.  If the optional Host mode
 logon processing is in effect, the command is restricted by the access
 restriction code.


 TYPE d:\path\filename
 ---------------------
 Cause a file to be typed or displayed by the Host system.  The command is
 equivalent to a character protocol SEND command.  The display can be
 cancelled by entering Ctrl C.


 XRCV d:\path\filename
 ---------------------
 Prepare the Host system to receive the designated file using the Xmodem
 protocol.  The filename specifies the file to receive the data.

 Note:  The caller may send the file using Xmodem, Xmodem-CRC or
 Xmodem(Large Block) and the Host system will detect and adjust for the
 error correction method and block size.


 XSEND d:\path\filename
 ----------------------
 Prepare the Host system to send the designated file using the Xmodem
 protocol.


 X1KSEND d:\path\filename
 ------------------------
 Prepare the Host system to send the designated file using the Xmodem
 (Large Block) protocol.

 YGRCV [d:\path\filename]
 ------------------------
 Prepare the Host system to receive the designated file using the Ymodem-G
 protocol.  The wildcard characters * and ? may be used in the filename or
 extension to allow multiple files to be transferred using a single
 command.

 If the optional drive, path and file name are not specified, the command
 will use the data in the protocol header block.


 YRCV [d:\path\filename]
 -----------------------
 Prepare the Host system to receive the designated file using the Ymodem
 protocol.  The wildcard characters * and ? may be used in the filename or
 extension to allow multiple files to be transferred using a single
 command.

 If the optional drive, path and file name are not specified, the command
 will use the data in the protocol header block.

 Note:  The caller may send the file using Ymodem or Ymodem (Large Block)
 and the Host system will detect and adjust for the block size.


 YSEND d:\path\filename
 ----------------------
 Prepare the Host system to send the designated file using the Ymodem
 protocol.  The wildcard characters * and ? may be used in the filename or
 extension to allow multiple files to be transferred using a single
 command.

 Note:  The caller may specify Ymodem-G to receive the file and the Host
 system will detect and adjust for the block size and transmission method.


 Y1KSEND d:\path\filename
 ------------------------
 Prepare the Host system to send the designated file using the Ymodem
 (Large Block) protocol.  The wildcard characters * and ? may be used in
 the filename or extension to allow multiple files to be transferred using
 a single command.

 Note:  The caller may specify Ymodem-G to receive the file and the Host
 system will detect and adjust for the block size and transmission method.


 ZSEND d:\path\filename
 ----------------------
 Prepare the Host system to send the designated file using the Zmodem
 protocol.  The wildcard characters * and ? may be used in the filename or
 extension to allow multiple files to be transferred using a single
 command.
